home *** CD-ROM | disk | FTP | other *** search
/ Belgian Amiga Club - ADF Collection / BS1 part 41.zip / BS1 part 41 / Devpac 2.12 disk 1.adf / README < prev    next >
Text File  |  1989-02-07  |  5KB  |  143 lines
  1. Devpac Amiga 2        Release 2.12
  2. ==============        ============
  3.  
  4. Although individual program version numbers may vary, the
  5. version number that should be written on your registration
  6. card should be 2.12. When requiring technical support or
  7. reporting bugs, please be sure to also quote the version
  8. number of the individual program in question.
  9.  
  10. Please note that due to the increased intelligence of the
  11. assembler, the Tutorial on page 12 is no longer completely
  12. valid. After correcting the MOV.L (2nd paragraph) and re-
  13. assembling to Memory, the assembler will give an 'odd
  14. address' error which should be ignored for the purpose
  15. of the Tutorial.
  16.  
  17. We have added many new features to Devpac Amiga since version
  18. 2.08, detailed below:
  19.  
  20. Editor
  21. ======
  22. Shift-Amiga-A assembles without the options requestor.
  23.  
  24. Shift-Amiga-L loads a file without the ARP requestor for the
  25. benefit of slow hard-disk users.
  26.  
  27. Assembler
  28. =========
  29. Various bugs have been fixed, including multi-line macro
  30. calls, quoted section names and BSS sections. In addition
  31. it is now possible to pass quoted filenames to GenIm2.
  32.  
  33. Expressions of the form lab1-lab2 are now allowed when lab1
  34. and lab2 are both in another section (which must be the same
  35. section).
  36.  
  37. When using Word- or Long-sized indirection, addresses are checked
  38. to be even, for example MOVE.L 5,A6 will give an error.
  39.  
  40. The register list syntax produced in MOVEM lists from MonAm
  41. is now accepted by GenAm.
  42.  
  43. The | character is now accepted as a bitwise OR operator (for
  44. all you C programmers!)
  45.  
  46. Symbols set using REG may now be used in expressions, with a
  47. warning. Their value is the same as that used in the MOVEM op.
  48.  
  49. If generating executable, absolute code you may specify ORG.W
  50. which will force all program references to be short-word.
  51.  
  52. The RORG directive is now supported for compatibility.
  53.  
  54. There are several new optimisations that the assembler can
  55. perform, using OPT O. Additional types are:
  56.     3    Short Word Addressing
  57. References to absolute addresses in the range 0-7FFF and
  58. FFFF8000 to FFFFFFFF will be optimised.
  59.     4    MOVEQ optimising
  60. Statements of the form MOVE.L <expr>,Dn will be optimised
  61. to MOVEQ if <expr> is -128 to 127 inclusive.
  62.     5    Quick Optimising
  63. Statements of the form ADD # and SUB # will be optimised
  64. to ADDQ / SUBQ if possible.
  65.     6    Warning of short branches
  66. Not strictly an optimisation, OPT OW6+ in combination with
  67. OP O1+ will give warnings on forward branches that can be
  68. made short so you may optimise them yourself.
  69. The warning messages produced by each optimisation may be
  70. individually controlled, using OPT OWx+ / OPT OWx- where
  71. 'x' is the optimising number (shown above), e.g. OPT OW3+
  72.  
  73. There is a new option which can be used to detect typing
  74. errors, OPT i. With this on, any indirect, absolute reference
  75. (other than location 4) will give the error '# probably
  76. missing'. For example, the line
  77.     and.b $df,d1
  78. will give an error as and.b #$df,d1 is really intended. This
  79. can be overidden on a line-by-line basis (e.g. for hardware
  80. register access) by specifying the expression within brackets
  81. and using .W or .L, for example move.l (_ciabase).L,d0
  82.  
  83. When using the stand-alone version of the assembler it is
  84. possible to define labels on the command-line using the
  85. -e option, which should be followed by one or more
  86. assignments, separated by commas or spaces. Such
  87. definitions are parsed as if they were the second line in
  88. the source (i.e. after any options). For example,
  89.     genim2 test -l -e TYPE=4,OUTPUT=1
  90.  
  91. The '@' character is now allowed in symbols, except when
  92. followed by a digit from 0-7 when it is taken as the start
  93. of an octal number. This is for Lattice C 5.0 users.
  94.  
  95. Shell 1.3 Users: GenIm2 may be made resident. GenAm2/MonAm2
  96. must not be made resident as they are not re-entrant.
  97.  
  98. Debugger
  99. ========
  100. Various bugs have been fixed, including disassembling certain
  101. BTST instructions, the register window display, 68020/030
  102. compatibility, Ctrl-T on a breakpoint, symbol character
  103. significance, and cross-referencing.
  104.  
  105. All memory is now checked before it is read to ensure it exists.
  106. Previously any reads of hardware registers (@C00000) or accidental
  107. reads because of wrap-around could cause nasty crashes. Invalid memory 
  108. is displayed as **
  109.  
  110. The Alt-O command can be repeated by pressing space after it shows 
  111. the numbers.
  112.  
  113. The default printer is now nothing, previously it was PRT:
  114.  
  115. 68020/030 Users: please note the instruction cache is turned
  116. off while MonAm is loaded to prevent nasty interactions with
  117. the debugger. The cache is restored to its original state when
  118. the debugger terminates. Disabling the cache will produce a
  119. performance degradation for which we can only apologise. Please
  120. also note that the Tutorial in section 1.11 is not valid for
  121. these processors because they allow the odd-access that is used
  122. in the example.
  123.  
  124. Disk Details
  125. ============
  126.  
  127. In order to make space on Disk 1, the following files and
  128. directories have been deleted:
  129.     Utilities    all
  130.     Fonts        all except Topaz
  131.     System        some
  132. You can find these files on your original Workbench disk that
  133. came with your machine.
  134.  
  135. When using GenAm2 and MonAm2 on PAL machines with external RAM,
  136. you may sometimes get *two* mouse pointers; one will be the
  137. normal Intuition pointer, the other will be the custom pointer
  138. associated with the program you are using. Do not be alarmed -
  139. this seems to be a harmless bug in Intuition.
  140.  
  141. Last changed: 7 Feb 1989
  142.  
  143.